home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / ck3012.zip / CARDKING.DOC < prev    next >
Text File  |  1990-11-01  |  13KB  |  302 lines
  1.  
  2.  
  3.  
  4.                                  Card Kingdom
  5.                                 **************
  6.                                   Multi-Node
  7.                                  Version  3.0
  8.                              Release Date 11-01-90
  9.  
  10.                             A Blue Foxx Live Door
  11.                                  Production
  12.  
  13.                                  Written By:
  14.  
  15.                                  Tim Maloney
  16.                                  P.O. Box 230
  17.                                Altus, Ok, 73521
  18.  
  19.                               The Blue Foxx BBS
  20.                                 (405) 482-3855
  21.                              300/1200/2400 24 hrs
  22.  
  23.  
  24.  
  25. Regardless of how you recieved this product it is provided "AS-IS" without
  26. any warranty or guarantee. You the end user accept full responsibilty for
  27. using this product. By using this product you do so solely at your own risk.
  28. You agree to hold the author free from any responsibility regarding loss of
  29. profits, system damage (software or Hardware) or any other incidental,
  30. special or unmentioned damages resulting from the use or inability to use
  31. this end product.
  32.  
  33.  
  34. This product is being distributed under the SHAREWARE concept. You may use it
  35. for a period of time. After this time period you must either register the
  36. product for your own use or discontinue using it. All Blue Foxx products
  37. carry a Date stamp and after a certain period of time the SHAREWARE versions
  38. will no longer function! Registered versions are registered to one individual
  39. only and soley to that individual for use on that individuals own system.
  40. Registered versions will contain an extra file with special information
  41. pertaining to registered users.  The registered versions MAY NOT be
  42. distributed by anyone other than the author of this product. SHAREWARE
  43. (UNREGISTERED) versions may be distributed freely by any BBS as long as no
  44. fee is charged for this particular product and this product is not included
  45. with any other product when distributed. The product must not be modified in
  46. any way, shape or form without the written permission of the author!
  47.  
  48.  
  49.  
  50.  
  51. Now that thats taken care of lets get down to the good stuff!!
  52.  
  53. This Door is a Production of Blue Foxx Software. At some later date in
  54. time it will cease to operate. The time frame may be from already expired
  55. to 3 months or less, depending on when you received this door. This is what
  56. is known as a cripple door, honesty has always been the best policy but
  57. sometimes a small reminder never hurt. I would have liked to distribute
  58. these doors as open as possible but it seems that some people would like
  59. to test the doors for a period that went into years.  If these doors had
  60. a warranty period it would have been up long ago. Anyways I have begun
  61. distributing these doors like this so that everyone will have a some time to
  62. determine if it is what they want or not. Also Registered Version may or may
  63. not have extra or enhanced options for players or Sysops.
  64. If you have any ideas on improving this or any other door that I have wrote,
  65. please feel free to tell me. I'm always looking for suggestions, good or bad.
  66.  
  67.  
  68.  
  69. See the end of this DOC on how to register:
  70.  
  71.  
  72. Now on to the good stuff:
  73.  
  74. All major changes will be marked <NEW>. These should be read as they
  75. may contain information that if not included properly may cause the
  76. door not to operate.
  77. Any other changes were considered to minor to document or place within
  78. this documentation.
  79.  
  80. The following files should be included in this package:
  81.  
  82. CK*.EXE         Main game program
  83. CARDKING.INS    The instructions file (In Ascii) for players.
  84. CARDKING.CFG    A quick file to get it up in local mode fast.
  85.                 Please rename any config file that you use to
  86.                 CARDKING.CFG or the door may not run properly
  87.                 in LOCAL mode only. (See instructions below)
  88.                 LOCAL IS DEFINED AS FROM DOS. If you enter it
  89.                 while logged on LOCALLY to your BBS it will work
  90.                 with ANY config filename.
  91. CHECKNEW.EXE    If this file is present it would allow you to update
  92.                 a previously running version to this version if necessary.
  93.  
  94. FILE YOU MUST SUPPLY:
  95. BRUN45.EXE      This must be a patched copy and must be in your PATH
  96.                 (Any patched copy will do, and this file is no longer
  97.                 included in the door program. If you don't have a copy
  98.                 it is on many BBS' already and you may call mine and
  99.                 download it anytime if you need it.
  100. SFDOORS.DAT     Supplied by your BBS. Or the door monitor that you use
  101.                 to run doors for other BBS systems.
  102.  
  103. I suggest you rename the main file to CARDKING.EXE This will help you
  104. to keep track of the associated programs and also make it easier if you
  105. add a newer version. You will not have to change your BAT/Monitor files
  106. in the future, if you start off with a name such as this. All other files
  107. MUST NOT BE RENAMED or an error may result.
  108.  
  109. THESE FILE MUST NOT BE DELETED OR THE GAME WILL NOT RUN LOCAL OR OTHERWISE!
  110. IF ANY OF THESE FILES IS ACCIDENTLY DESTROYED THE FOLLOWING SHOULD HELP YOU
  111. TO REBUILD THEM.
  112.  
  113. Files created as the door needs them:
  114.  
  115. CARDKING.PLY    The Players statistics file. This is now created if
  116.                 it does not already exist.
  117.  
  118. *.DAY           Created each new day to keep track of how many times a
  119.                 player can play each day. This file is not created if
  120.                 you have set the amount of times a user can play to "U"
  121.                 in the *.CFG file.
  122.  
  123. *.BAD           Created when a caller drops carrier in the door. This is
  124.                 to let the Sysop know who may have had a problem in the
  125.                 door and the Sysop can then ask them about it.
  126.                 It has been suggested to have this go to the HEYSYSOP.LOG
  127.                 or the CALLERS.LOG. If you would like to vote on this please
  128.                 let me know. Reason being this door supports different BBS
  129.                 types and making them all compatable can be a chore.
  130.  
  131. *.ERR           Created whenever an ERROR results in the door. This will NOT
  132.                 be created if the door is not properly set up. Most of the
  133.                 ERROR numbers generated can be found in your DOS BASIC
  134.                 reference manual. If you get one that you cannot identify
  135.                 please feel free to leave me a message.
  136.  
  137. STEP 1:
  138.         THE CONFIG FILE
  139. Your config file should contain the folowing:
  140.  
  141. UNREGISTERED            Place Your Registration number here
  142. BBSTYPE                 Either SPITFIRE, QBBS or WILDCAT
  143. BBSNAME                 The Name of YOUR BBS
  144. SYSOPFIRST              The Sysops First Name
  145. SYSOPLAST               The Sysops Last Name
  146. c:\xxx\doorinfo.xxx     PATH AND NAME to either CALLINFO.BBS OR SFDOORS.DAT
  147. 60                      Time a user can be in the door (subject to time left)
  148. c:\xxx\xxx\color.bul    PATH AND NAME for the Color Bulletin
  149. c:\xxx\xxx\mono.bul     PATH AND NAME for the Mono Bulletin
  150. U                       Number of times a user can enter the door each day.
  151.                         U is unlimited times
  152.                         Change the U to a 1,2,3 etc to limit number of plays
  153.  
  154. The game will sense if you lock DTE and take appropriate steps to insure that
  155. proper locking takes place. The door has only been tested to 19,200 baud and
  156. only on comm ports 1 and 2.
  157.  
  158. I suggest you rename the config file after the *.DAT file
  159. Ex... CARDKING.CFG
  160. This will allow you to keep better track of the related files, and allow
  161. quick entry when entering from LOCAL mode.
  162.  
  163. For other nodes I suggest CARD2.CFG for node 2, CARD3.CFG for 3 etc..
  164.  
  165. STEP 2:
  166.        DATA FILES:
  167. Just copy all of the above files into the directory that you wish to
  168. run the door from.
  169.  
  170.  
  171. Layout for the *.INS file:
  172.     This is a strickly ASCII TEXT file with nothing special in it!
  173.     The door itself manages the instructions file and if you see
  174.     anything that should be added you can simply use an ASCII text
  175.     editor.
  176.  
  177. Layout for the *.PLY file:
  178.     ##                        <=- Number of Players (not including Champs)
  179.     Top Champ , Score , Date  <=- Name of Top Champ a comma Top Score comma
  180.                                    and a date 10-01-89
  181.     Last Champ, Score , Date  <=- Name of Last Champ a comma Last Score comma
  182.                                   and a date 10-01-89
  183.     Player 1, Score, Date, 0, 0, 0, 0, 0, 0
  184.     |         |      |     |  |  |  |  |  |
  185.     |         |      |     |  |  |  |  |  ## Of Knights Player Has
  186.     |         |      |     |  |  |  |  |
  187.     |         |      |     |  |  |  |  ## Of Guards Hired
  188.     |         |      |     |  |  |  Gambler Cash
  189.     |         |      |     |  |  Gambler (0 or 1)
  190.     |         |      |     |  Bandit Cash Stolen
  191.     |         |      |     ## Bandits Hired
  192.     |         |      Last Date Played
  193.     |         The Players Score
  194.     The Players Name
  195.  
  196.    This file now creates itself. This information is
  197.    provided for the Sysop who may need it.
  198.  
  199.  
  200.  
  201.  
  202. BRUN45.EXE must be in your path somewhere. Also it must be patched for
  203. DTR or the door may drop carrier on the caller when entering. It will
  204. work fine locally but not remote. Any patched copy will usually do and
  205. if it is in your path then you will only need ONE copy anywhere on your
  206. drives!!
  207.  
  208.  
  209.  
  210. STEP 3:
  211.         STARTING THE GAME:
  212. This is the easiest part.
  213.  
  214.            A. LOCAL:
  215.            Just type the name of the game and it will do the rest.
  216.            In Local mode the door will load the CARDKING.CFG file
  217.            automatically. Please be sure you have named it CARDKING.CFG
  218.            or the door will not function properly in local mode.
  219.            The Sysops name will be taken from this file for use in
  220.            the game. Future releases of this door may or may not
  221.            utilize this as a way of identifying the Sysop!
  222.  
  223.            ex. CARDKING local or CARDKING
  224.  
  225.         B. AS A DOOR:
  226.            First you must Change Directory (CD or CHDIR) into
  227.            the directory containing the door. Then type the name of the
  228.            door ,a space, and the name of your config file.
  229.            ex. CD \DOOR
  230.                CARDKING CARDKING.CFG
  231.            remember to change back to your calling directory with a CD
  232.            on the line following the one that calls the door.
  233.  
  234.            MULTI-NODE OPERATION:
  235.            You must have a seperate CFG file for each Node that you wish
  236.            to put this door on. Only one EXE file is necessary and starting
  237.            the door would be as follows for each door.
  238.  
  239.                  ex. CD\DOOR
  240.                      CARDKING CARD2.CFG   <=- Node 2
  241.  
  242.                      CD\DOOR
  243.                      CARDKING CARD3.CFG   <=- Node 3 etc
  244.  
  245.            Most Sysops will already be familiar with their BBS Doors and
  246.            will only have to add the above lines into whatever batch file
  247.            of door monitor file that will eventually call the door.
  248.  
  249. EXAMPLE BATCH FILE TO CALL THIS DOOR:
  250. ECHO OFF
  251. E:
  252. CD E:\SF\DOORGAME
  253. {exefilename} {configfilename}
  254. CD E:\SF
  255.  
  256. And there you have it.. If I have left anything out or if you have any
  257. suggestions for this or future doors....
  258.  
  259. Give me a call at The Blue Foxx BBS (405) 482-3855 (300/1200/2400 24hrs)
  260.  
  261.  
  262. If you would like to register this program:
  263.  
  264.  
  265.         Send $10 And the Name Of The Door you wish to register.
  266.         To:
  267.            Tim Maloney
  268.            Blue Foxx BBS
  269.            P.O. Box 230
  270.            Altus OK, 73521
  271.  
  272.          Please Include the NAME you wish to Place on Your Registered
  273.          Version. Preferably this is the Sysops First and Last Name.
  274.  
  275. Your Registered Copy will Be available For immediate Download From
  276. the Blue Foxx BBS. If you wish to be pre-registered on the Blue Foxx please
  277. include the folowing with your registration:
  278.         First and Last Name you will use. (No Aliases)
  279.         Password
  280.         Birthdate
  281.         Mailing Address
  282.         City, State & ZIP Code
  283.  
  284. This does not have to be fancy.. Just tear off any old piece of paper and
  285. write clear enough to read and mail it off.
  286.  
  287. If you wish just use the ole Print Screen routine here and fill in the
  288. blanks.. Thats what I see most anyways..
  289.  
  290. CARD KINGDOM $10-----
  291.  
  292. NAME (First and Last) __________________________________
  293.  
  294. Voice Phone Number _____________________________________
  295.  
  296. Password (if not already logged on) ____________________
  297.  
  298. In either Case if you have any suggestions feel free to call and leave
  299. me a comment.
  300.  
  301. *********************************** END OF DOC ****************************
  302.